home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / comm / tcp / NNTPd_12.lha / NNTPd_1.2 / man / newssys.5 < prev    next >
Text File  |  1995-08-17  |  10KB  |  266 lines
  1. newssys.5:52: warning: can't break line
  2.  
  3.  
  4.  
  5. NEWSSYS(5)                                             NEWSSYS(5)
  6.  
  7.  
  8. NAME
  9.        newssys - USENET network news sys (neighbours) file
  10.  
  11. DESCRIPTION
  12.        The file uunews:/sys describes which news groups this site
  13.        is willing to receive and which groups it  is  willing  to
  14.        transmit to each netnews neighbour.  It is public informa-
  15.        tion and is sent automatically to any site  that  sends  a
  16.        sendsys control message.  A sys line has four fields, sep-
  17.        arated by colons:
  18.  
  19.        system-
  20.        name/exclusion1,exclusion2...:subscriptions/distributions:flags:transmission
  21.        command
  22.  
  23.        A # as the first character in a line  denotes  a  comment.
  24.        Empty lines are ignored.  A (non-comment) sys entry may be
  25.        continued to the next line by putting a \ at  the  end  of
  26.        the  current  line.   Spaces  are permitted in sys only in
  27.        comments, transmission command when it really is a command
  28.        and  not a filename, and, for B news compatibility, at the
  29.        start of a continuation line (after a \ and a newline).
  30.  
  31.        Of the sys fields, only the system-name need  be  present.
  32.        If  a  field  and all the fields after it are omitted, the
  33.        colon immediately before that field  and  all  the  colons
  34.        after  it  may  be  omitted  too.   The optional subfields
  35.        (exclusions and distributions) and their  leading  slashes
  36.        may be omitted.
  37.  
  38.        The  system  name is the name of the system being sent to,
  39.        and is checked against site  names  in  Path:  headers  to
  40.        avoid  sending an article back to a site that has seen it.
  41.        The exclusions are also checked against the  Path:  header
  42.        and articles are not sent to system name if they have vis-
  43.        ited any of the exclusions.
  44.  
  45.        (The special system name ME stands for  the  name  of  the
  46.        machine   news   is   running   on,   as  determined  from
  47.        uunews:/whoami.  The ME line, or a line whose system  name
  48.        is  explicitly that of the machine news is running on, has
  49.        a rather different meaning from that of the other sys file
  50.        lines:  its  subscriptions  subfield  identifies the news-
  51.        groups that this site subscribes to (i.e.  is  willing  to
  52.        receive),  and its other fields and subfields are ignored.
  53.        There should be one such line in the file.)
  54.  
  55.        subscriptions is a comma-separated list of newsgroup  pat-
  56.        terns  specifying  the newsgroups to be transmitted to the
  57.        system; each newsgroup from the Newsgroups: header of each
  58.        article  is  matched  against the pattern list, and if any
  59.        newsgroup matches the pattern list, the article is  trans-
  60.        mitted.  The rules for matching a newsgroup against a sin-
  61.        gle pattern are:
  62.  
  63.  
  64.  
  65.                            9 Sept 1994                          1
  66.  
  67.  
  68.  
  69.  
  70.  
  71. NEWSSYS(5)                                             NEWSSYS(5)
  72.  
  73.  
  74.        +  words in a newsgroup or  a  pattern  are  delimited  by
  75.           periods;
  76.  
  77.        +  words  of  a pattern and a newsgroup match only if they
  78.           are identical, except that the word all  in  a  pattern
  79.           matches any newsgroup word;
  80.  
  81.        +  a  newsgroup is matched against a pattern word by word,
  82.           and all words must match for  the  newsgroup  to  match
  83.           that pattern;
  84.  
  85.        +  if  the pattern has fewer words than the newsgroup, the
  86.           pattern is implicitly extended to the  same  number  of
  87.           words by appending .all as many times as necessary;
  88.  
  89.        +  if  the newsgroup has fewer words than the pattern, the
  90.           newsgroup does not match the pattern;
  91.  
  92.        +  if pattern matches  a  newsgroup,  !pattern  mismatches
  93.           that newsgroup.
  94.  
  95.        A  newsgroup  matches  a  pattern list if, and only if, it
  96.        matches at least one of the patterns and:
  97.  
  98.        +  the newsgroup does not mismatch any of the patterns, or
  99.  
  100.        +  the  longest matched pattern is longer than the longest
  101.           mismatched pattern (length is  measured  in  number  of
  102.           words,  with each explicit occurrence of all counted as
  103.           slightly less than one word, and does not  include  the
  104.           implicit extension of patterns with .all).
  105.  
  106.        Note  that order in the lists is not significant, and that
  107.        ties are broken in favor of  not  matching.   An  example:
  108.        comp,comp.sys.sun,!comp.sys  matches  all the comp groups,
  109.        except the comp.sys groups but including comp.sys.sun.
  110.  
  111.        The distributions in the Distribution:  header  are  simi-
  112.        larly  matched against the distributions subfield, if any.
  113.        If no distributions are supplied,  Distribution:  will  be
  114.        matched against the subscriptions instead.  (The Distribu-
  115.        tion: header is ignored when receiving news;  it  is  only
  116.        significant when sending.)
  117.  
  118.        Note  that  some  older  news software reportedly attached
  119.        magical significance to the  distributions  ``world''  and
  120.        ``local'';  C  News  treats  them as ordinary distribution
  121.        names with no special properties (except that ``world'' is
  122.        the  default  distribution  of  an article if none appears
  123.        explicitly).   For  example,  a  distributions  list  like
  124.        all,!local will not prevent local articles from being sent
  125.        unless they contain explicit  Distribution:  local  lines.
  126.        Note too that the distribution ``world'' must be permitted
  127.        (perhaps by the distribution ``all'')  in  order  to  feed
  128.  
  129.  
  130.  
  131.                            9 Sept 1994                          2
  132.  
  133.  
  134.  
  135.  
  136.  
  137. NEWSSYS(5)                                             NEWSSYS(5)
  138.  
  139.  
  140.        Distribution:-less articles (the common case) to a site.
  141.  
  142.        The  flags are a set of letters describing how the article
  143.        should be transmitted.  Valid flags include  f  (interpret
  144.        transmission  command  as  a file name and write the arti-
  145.        cle's file name relative to uunews: and size in  bytes  on
  146.        the  end  of  it), F (like f but omit the size), I (like F
  147.        but write Message-ID:s instead of filenames),  n  (like  F
  148.        but  write  a  Message-ID:  after each filename), Ln (only
  149.        send articles generated within n hops of here;  0  is  the
  150.        default  value for n), m (transmit only moderated groups),
  151.        u (transmit only unmoderated  groups).   There  are  other
  152.        obsolete ones.
  153.  
  154.        The transmission command is executed by the shell with the
  155.        article to be transmitted as the standard input.  The sub-
  156.        string `%s' will be replaced at most once per command with
  157.        the name of a file containing  the  article,  relative  to
  158.        uunews:  (`%%' is replaced by `%').  The default is `uux -
  159.        -z -r sysname!rnews' for  a  command;  the  PATH  searched
  160.        includes  uunews:bin/relay, so that the commands described
  161.        in newsmail(8) are available as alternatives to  uux.   If
  162.        one  of  the  flags has caused this field to be taken as a
  163.        filename, the default  is  uunews:/out.going/sysname/togo;
  164.        if  a filename is given but it does not start with `/', it
  165.        is assumed to be relative to the uunews:/out.going  direc-
  166.        tory.
  167.  
  168. EXAMPLES
  169.        A complex sys file.
  170.  
  171.             # line indicating what we are willing to receive; note local groups near end
  172.             ME:comp,news,sci,rec,misc,soc,talk,can,ont,tor,ut,to
  173.             # sample insignificant feed not using batching (for special situations only)
  174.             huey:news.config,to.huey/all::uux - -r -gd huey!rnews
  175.             # sample of mailing newsgroups to someone (note distribution)
  176.             daisy:soc.women,soc.couples/all::mail daisy@duck
  177.             # sample small feed using batching
  178.             gladstone:comp.protocols.tcp-ip,rec.aviation/all:f:
  179.             # sample major batched feed, including assorted regional newsgroups, with
  180.             # (unnecessary) explicit file name
  181.             dewey:comp,news,sci,rec,misc,soc,talk,can,ont,tor,ut,to.dewey/all:f:dewey/togo
  182.             # sample long-haul feed; note no regional groups, exclusion of a local
  183.             # distribution, and exclusion of anything that passed through him under
  184.             # another name (needed because he puts that form, not just "donald", in
  185.             # his Path lines)
  186.             donald/donald.angry.duck:comp,news,sci,rec,misc,soc,talk,to.donald/all,!ut:f:
  187.             # sample local-postings-only feed direct to major site (gets them out fast)
  188.             scrooge:comp,news,sci,rec,misc,soc,talk,to.scrooge/all:Lf:
  189.             # sample ihave/sendme link
  190.             # NOTE, this is uucp ihave/sendme, not related to NNTP in any way.
  191.             # Send ihave telling louie what we have -- batcher turns the batch into a
  192.             # giant control message and posts it to "to.louie".
  193.             louie.wehave/louie:comp,news,sci,rec,misc,soc,talk,!to/all:I:
  194.  
  195.  
  196.  
  197.                            9 Sept 1994                          3
  198.  
  199.  
  200.  
  201.  
  202.  
  203. NEWSSYS(5)                                             NEWSSYS(5)
  204.  
  205.  
  206.             # Send the actual control messages
  207.             louie:to.louie/all:f:
  208.             # Also, since ihave/sendme is slow, send local postings to louie without
  209.             # waiting for ihave/sendme
  210.             louie:comp,news,sci,rec,misc,soc,talk,!to/all:Lf:
  211.             # for a site we feed with snntp
  212.             zaphod.mps.ohio-state.edu:all:n:uunews:/out.nntp/zaphod.mps.ohio-state.edu
  213.  
  214.        (The  ``to.sysname'' groups are normal newsgroups used for
  215.        testing individual news feeds and  conveying  ihave/sendme
  216.        messages.)
  217.  
  218. FILES
  219.        uunews:/sys
  220.  
  221. SEE ALSO
  222.        newsbatch(8CN), relaynews(8CN)
  223.  
  224. HISTORY
  225.        Written  by Geoff Collyer and Henry Spencer for the C News
  226.        project.
  227.  
  228. BUGS
  229.        The flags field is a bit of mess: there are too many  for-
  230.        matting flags and they aren't orthogonal.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.                            9 Sept 1994                          4
  264.  
  265.  
  266.